<?php
namespace app\api\interfaces;

/**
 * @name 素材模块
 * @sort 6
 */
interface MaterialInterface
{

    /**
     * @name 同步<span style="color:red">素材</span>数据
     * @sort 1
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @remark <p style='color:red'>0、请注意：不传递begin_date与end_date时间：统计当前月的数据<p/><p style='color:red'>1、最多一次性获取7天的数据</p><p>2、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据。</p><p>3、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。</p><p>4、为确保公众号数据已完成统计和处理，请于每天上午8点后查询公众号前一天的数据</p>
     */

    public function actionSync_material();
    /**
     * @name 增加图片分组
     * @sort 2
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:name,v:xxxx,t:分组名称,n:
     * @case {"group_id#分组id": "fe87f1463d312a33dd36d6ffb906b6f4","name#分组名称": "微信"}
     */
    public function actionGrouping_add();
    /**
     * @name 修改图片分组
     * @sort 3
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:group_id,v:asdsadsadczxzx54653343,t:分组id,n:
     * @post k:name,v:xxxx,t:分组名称,n:
     * @case {"group_id#分组id": "fe87f1463d312a33dd36d6ffb906b6f4","name#分组名称": "微信"}
     */
    public function actionGrouping_upd();
    /**
     * @name 删除图片分组
     * @sort 4
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:group_id,v:asdsadsadczxzx54653343,t:分组id,n:
     * @case {"code":200,"flag":true,"msg":"\u5220\u9664\u6210\u529f\uff01","data":[],"success":true,"errorData":[],"md5":"31ca873112f16f85d892b3fffb99cee9","alg":"SALT_MD5"}
     */
    public function actionGrouping_del();
    /**
     * @name 分组列表
     * @sort 5
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @case [{"id#分组id": "5c686e4f77d0aab831e6ec7f73ae2866","name#分组名称": "微信","add_time#添加时间": null},{"":""}]
     */
    public function actionGrouping_list();
    /**
     * @name 移动图片分组
     * @sort 6
     * @date 2018-08-01
     * @post k:appid,v:wx403a8141dca36f45,t:授权公总号appid,n:
     * @post k:group_id,v:asdsadsadczxzx54653343,t:分组id,n:
     * @post k:img_ids,v:asdsadsadczxzx54653343，dasdasd,t:图片id集合,n:
     * @case {"num#移动分组的图片成功个数": 4}
     */
    public function actionImg_move_group();

    /**
     * @name  获取素材列表
     * @sort 7
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:type,v:image,t:素材的类型，图片（image）、视频（video）、语音 （voice）,n:
     * @post k:page,v:1,t:分页,n:
     * @post k:page_size,v:15,t:返回素材的数量，取值在1到20之间(默认15)
     * @post k:group_id,v:xxxxxxx,t:分组id
     * @case {"index#当前分页":"1","type#返回素材类型图片（image）、视频（video）、语音 (voice）":"image","size#当前显示数量":"10","count#总数":30,"pages#总页数":"2", "data#具体数据":[{"id#素材id":"622791d2136094836c1961fe360bad98","media_id#素材微信id（很重要）": "P9SnSnx3SJDz0YvYnWUwd-Wj50YPllKs8WwKvV6uMqM","title#素材名称": "CropImage","update_time#素材微信更新时间": "2018-08-08 10:08:16","url#素材图片地址": "http://mmbiz.qpic.cn/mmbiz_jpg/FVJWbQSVbKtRq3viaezA4I8ylluATOX10eUL7bDsoIE9iczMhcZETFh95rgezychgaDrrdgF5d6aJFB8JVmKb2kA/0?wx_fmt=jpeg","add_time#同步素材时间":"2018-08-03 11:20:03","group_id#分组id":"0"},{"":""}]}
     * @remark <p style="color:red">参考微信手册：<a href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738734" target="_blank">获取素材</a></p>
     */
    public function actionTemp_list();

    /**
     * @name  获取素材分组统计
     * @sort 8
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:type,v:image,t:素材的类型，图片（image）、视频（video）、语音 （voice）,n:
     * @case {"type#素材类型":"image","data":[{"num#素材数量": 39,"group_name#素材分组名": "全部图片","group_id#素材分组id": null},{"":""}]}
     */
    public function actionTemp_group_list();

    /**
     * @name  获取<span style='color:red'>图文</span>素材列表
     * @sort 9
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:page,v:1,t:分页,n:
     * @post k:key,v:杨,t:搜索关键词
     * @post k:pageSize,v:1,t:返回素材的数量，取值在1到20之间(默认15)
     * @case {"index#当前分页":"1","size#当前显示数量":"10","count#总数":30,"pages#总页数":"2", "data#具体数据":[{ "id#ID":"03fa06a542308ad3b81c95b1fde8ab20","media_id#素材微信id": "atEoQdAuSfnFV38yheYEvRntnyAGJHqpkxrOOBnJNRE","add_time#素材更新时间": "2018-09-05 18:03:59","update_time#素材微信更新时间": "2016-08-03 15:37:00","items":[{"id": "571bcbb66c74a1367ed542ada78eb4db","material_id#系统ID": "03fa06a542308ad3b81c95b1fde8ab20","title#素材文章标题": "皮个布早教课程","thumb_media_id#封面图片素材id": "atEoQdAuSfnFV38yheYEvdnEXJ3R2OdjA-VuB3AJoik","url#多图文详情页面地址": "http://mp.weixin.qq.com/s?__biz=MzI0NDQ1MTQ0Mg==&mid=100000002&idx=1&sn=23d0acd2e9e1b60fb61a52a5f07f871d#rd","thumb_url#多图文封面图片地址": "http://mmbiz.qpic.cn/mmbiz/7wicYrkoTBbB8AhlShHM1jqJta1U14JgtMicLnFIHictoYMbnByibAtYSRo8SfT2A7QUC6U2KNluZOBowrsfNKBcjA/0?wx_fmt=png","author#作者": "布布","digest#摘要": "【国际品牌】 【All Yes You Can】 【学术机构】 【星级师资】","show_cover_pic#是否显示封面图片：0：不显示，1：显示": "0","content#内容（有html）":"asdjsal", "content_source_url#原文链接": "","update_time#【微信】当前文章的最后更新时间": "2016-08-03 15:37:00","create_time#【微信】当前文章创建时间": "2016-07-14 11:41:05"},{"":""}]},{"":""}]}
     * @remark <p style="color:red">参考微信手册：<a href="https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738734" target="_blank">获取素材</a></p>
     */
    public function actionTemp_article_list();



    /**
     * @name  获取素材数量
     * @sort 10
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @case { "voice_count#语音总数量": 0,"video_count#视频总数量": 0,"image_count#图片总数量": 6,"news_count#图文总数量": 3}
     */
    public function actionTemp_list_num();
    /**
     * @name  增加素材
     * @sort 11
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:type,v:image,t:媒体文件类型，分别有图片（image）、语音（voice）、视频（video）和缩略图（thumb）,n:
     * @post k:title,v:xxxxxxxxxx,t:素材标题【type=video必须传递】
     * @post k:intro,v:xxxxxxxxxxxxxxx,t:素材描述【type=video必须传递】
     * @case {"media_id#微信素材id": "P9SnSnx3SJDz0YvYnWUwd7pAY5EeSAXgVQ6DfQNc_iQ","url#素材访问地址【微信：图片素材才有此字段】": "http://mmbiz.qpic.cn/mmbiz_jpg/FVJWbQSVbKu2da21MPiaF9Ouo2JsD2WQwaZHUwrt5sic7MqWxl9ZTx7dwia5KxMqZSw2ptscRcmM2HJpJf9alcwtw/0?wx_fmt=jpeg"}
     * @remark 1、上传文件 Content-Disposition: form-data; name="file"; filename="logo.png"<br>2、素材的格式大小等要求与公众平台官网一致：<br>图片（image）: 2M，支持bmp/png/jpeg/jpg/gif格式<br>语音（voice）：2M，播放长度不超过60s，mp3/wma/wav/amr格式<br>视频（video）：10MB，支持MP4格式<br>缩略图（thumb）：64KB，支持JPG格式
     */
    public function actionTemp_add();

    /**
     * @name  增加图文素材
     * @sort 12
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:articles,v:{""：""},t:图文数据json,n:
     * @post-remark-articles [{"title#标题":"你好","thumb_media_id#图文消息的封面图片素材id（必须是永久mediaID）":"dadasdas4635aas","show_cover_pic#是否显示封面，0不显示，1显示":"0","content":"具体内容（可以包含html其中的图片必须先要上传到微信）","content_source_url#原文地址":"https://blog.csdn.net/znit2003/article/details/41699055","author#作者（可以不传值）":"张三", "digest#摘要（可以不传值）":"64字符"},{"":""}]
     * @case {"id#素材id":"sz,kdjaskldjklas354545asdas","media_id#素材微信id":"ajksdhakjsdh235341"}
     * @remark <p>1、content：图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤</p>
     */
    public function actionArticle_add();

    /**
     * @name  修改图文素材
     * @sort 13
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:id,v:xxxxxxxxxxxx,t:素材id,n:
     * @post k:articles,v:{""：""},t:图文数据json,n:
     * @post-remark-articles [{"title#标题":"你好","thumb_media_id#图文消息的封面图片素材id（必须是永久mediaID）":"dadasdas4635aas","show_cover_pic#是否显示封面，0不显示，1显示":"0","content":"具体内容（可以包含html其中的图片必须先要上传到微信）","content_source_url#原文地址":"https://blog.csdn.net/znit2003/article/details/41699055","author#作者（可以不传值）":"张三", "digest#摘要（可以不传值）":"64字符"},{"":""}]
     * @case {"id#素材id":"sz,kdjaskldjklas354545asdas","media_id#素材微信id":"ajksdhakjsdh235341"}
     * @remark <p>1、content：图文消息的具体内容，支持HTML标签，必须少于2万字符，小于1M，且此处会去除JS,涉及图片url必须来源 "上传图文消息内的图片获取URL"接口获取。外部图片url将被过滤</p>
     */
    public function actionArticle_upd();



    /**
     * @name  删除素材
     * @sort 14
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:id,v:2sadhksdh201444,t:素材id,n:
     * @case {"code":200,"flag":true,"msg":"删除素材成功","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionTemp_del();


    /**
     * @name  批量删除素材
     * @sort 15
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @post k:id,v:2sadhksdh201444,t:素材id(多个逗号隔开),n:
     * @case {"code":200,"flag":true,"msg":"删除素材成功","data":[],"success":true,"errorData":[],"md5":"bf7823b4c63540c484632b2db1b844f1","alg":"SALT_MD5"}
     */
    public function actionTemp_batch_del();

    /**
     * @name  上传图文内的图片获取URL
     * @sort 16
     * @post k:appid,v:wx403a8141dca36f45,t:微信公众号appid,n:
     * @case {"url#图片地址":"http://mmbiz.qpic.cn/mmbiz_jpg/FVJWbQSVbKvp52FQBrZ6VibcVQXJBFic8X6TUsZhvm4CKiaqTDDVFiaOib10A6APBpGosrdA1kcmxuO1da2fnRIfQpA/0"}
     * @remark 1、上传文件 Content-Disposition: form-data; name="file"; filename="图片.png"<br>2、素材的格式大小等要求与公众平台官网一致：<br>图片（image）: 1M，支持jpg/png格式，无次数限制。
     */
    public function actionTemp_img_add();



}